package cn.lngaosu.lwyd.module.integration.service.weixinarticleanalysis;

import java.util.*;
import javax.validation.*;
import cn.lngaosu.lwyd.module.integration.controller.admin.weixinarticleanalysis.vo.*;
import cn.lngaosu.lwyd.module.integration.dal.dataobject.weixinarticleanalysis.WeixinArticleAnalysisDO;
import cn.lngaosu.lwyd.module.integration.dal.dataobject.weixinarticleanalysis.WeixinArticleAnalysisSourceDO;
import cn.lngaosu.lwyd.framework.common.pojo.PageResult;
import cn.lngaosu.lwyd.framework.common.pojo.PageParam;

/**
 * 微信文章分析 Service 接口
 *
 * @author 张恒
 */
public interface WeixinArticleAnalysisService {

    /**
     * 创建微信文章分析
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createWeixinArticleAnalysis(@Valid WeixinArticleAnalysisSaveReqVO createReqVO);

    /**
     * 更新微信文章分析
     *
     * @param updateReqVO 更新信息
     */
    void updateWeixinArticleAnalysis(@Valid WeixinArticleAnalysisSaveReqVO updateReqVO);

    /**
     * 删除微信文章分析
     *
     * @param id 编号
     */
    void deleteWeixinArticleAnalysis(Long id);

    /**
    * 批量删除微信文章分析
    *
    * @param ids 编号
    */
    void deleteWeixinArticleAnalysisListByIds(List<Long> ids);

    /**
     * 获得微信文章分析
     *
     * @param id 编号
     * @return 微信文章分析
     */
    WeixinArticleAnalysisDO getWeixinArticleAnalysis(Long id);

    /**
     * 获得微信文章分析分页
     *
     * @param pageReqVO 分页查询
     * @return 微信文章分析分页
     */
    PageResult<WeixinArticleAnalysisDO> getWeixinArticleAnalysisPage(WeixinArticleAnalysisPageReqVO pageReqVO);

    // ==================== 子表（微信文章分析子表(按渠道区分)） ====================

    /**
     * 获得微信文章分析子表(按渠道区分)列表
     *
     * @param analysisId 分析表数据主键
     * @return 微信文章分析子表(按渠道区分)列表
     */
    List<WeixinArticleAnalysisSourceDO> getWeixinArticleAnalysisSourceListByAnalysisId(Long analysisId);

    /**
     * <p>作者: 张恒
     * <p>描述: 同步图文群发每日数据
     * <p>日期: 2025/6/19 16:45
     */
    void syncWeixinArticleSummary();

    /**
     * <p>作者: 张恒
     * <p>描述: 同步图文统计数据
     * <p>日期: 2025/6/19 16:45
     */
    void syncWeixinArticleUserread();

    /**
     * <p>作者: 张恒
     * <p>描述: 同步图文统计分时数据
     * <p>日期: 2025/6/19 16:45
     */
    void syncWeixinArticleUserreadhour();

    /**
     * <p>作者: 张恒
     * <p>描述: 同步图文分享转发数据
     * <p>日期: 2025/6/19 16:45
     */
    void syncWeixinArticleUsershare();

    /**
     * <p>作者: 张恒
     * <p>描述: 同步图文分享转发分时数据
     * <p>日期: 2025/6/19 16:45
     */
    void syncWeixinArticleUsersharehour();

}